Checkpoint

Verifies the value of a window or control property matches an expected value. If the values do not match, the script fails or continues and displays a message in the Errors pane.

Checkpoints can validate both visual and non-visual properties. For example, you can check that a window includes specific title bar buttons. See Using Checkpoints.

Note: Use the OCRCheckpoint statement to verify graphical text against an expected value.

Syntax

Checkpoint("PropertyName", ExpectedValue, FailureBehavior, "Warning")

Arguments

Argument Description
PropertyName Name of the property to check. You can view a list of all properties captured for the window or control when it was added to the application repository in the Properties dialog box. See Modifying window and control properties.
ExpectedValue Value to check.
FailureBehavior Optional failure behavior. True stops the script if the checkpoint fails. False displays a warning and continues playback. If not specified, True is used.
Warning Optional message to display in the Errors pane and run report when checkpoints fail.

Keyword View notes

The property and value to check is displayed as ("Property" = "Value") in the Information column.

Supported objects

Browser, Button, Calendar, Cell, CheckBox, ColumnHeader, ComboBox, ContextMenu, Control, DateTimePicker, EditBox, Grid, HTMLElement, HTMLLink, HTMLTable, Image, Item, Label, Link, ListBox, ListView, Menu, NavigationField, PopupMenu, ProgressBar, RadioButton, Row, RowHeader, ScrollBar, Slider, SpinBox, SubItem, Tab, TabBar, ToolBar, Tree, Window

Example

Window("WysiCorp Login").Button("buttonLogin").Checkpoint("Text", "Login", True, "Button text is incorrect")